TPUG - Toronto PET Users Group/TPUG Users Group CD/TPUG Users Group CD.iso/GEOS/(g)u2.d64/font edit1.2docs

Text File | 2007-02-04 | 10KB | 200 lines

                      ╟┼╧╙ ╞ONT ┼DITOR V1.2 ─OCUMENTATION
                                BY ╩IM ├OLLETTE
                           ├OPYRIGHT (├) ╩UNE 1988,
                             ┴LL RIGHTS RESERVED.


  ╙TARTING WITH THIS VERSION (1.2) ╔ AM MAKING THIS PROGRAM ╙╚┴╥┼╫┴╥┼. ╨LEASE
  SEND WHATEVER YOU FEEL IS APPROPRIATE ($5.00 WOULD BE GOOD) TO:

       ╩IM ├OLLETTE
       6782 ╩UNCTION ╥OAD
       ╨AVILION, ╬EW ┘ORK    14525-9755

  ╞OR AN ADDITIONAL $2.50 + A BLANK DISK ╔ WILL SEND YOU THE UN-COMPILED ┬┴╙╔├
  VERSION. (╘HE BLANK DISK ╔'LL SEND BACK TO YOU WITH THE PROGRAM ON IT.)

  ╔ AM HOPING THAT MANY OF YOU WILL TRY TO SEND SOMETHING. ╔ REALIZE THAT THE
  SHAREWARE CONCEPT DOESN'T ALWAYS WORK BUT ╔'M HOPING THAT IT WILL. ╔F ╔
  RECEIVE NOTHING AT ALL ╔ MAY JUST STOP UPLOADING THIS PROGRAM. (┬UT DON'T
  COUNT ON IT!) ┘ES, ╔ MYSELF ADMIT ╔ HAVE NEVER SENT ANY MONEY IN FOR
  SHAREWARE PROGRAMS. ┴T THE MOMENT, ╔'M BROKE. (GOT ABOUT $10 OR SO!)
  ╘HEREFORE, THE FIRST $15 ╔ RECEIVE WILL GO TO ┬ILL ╙HARP (GEO├OPE AUTHOR),
  THEN THE NEXT AMOUNT TO ├HRIS ╙MEETS (AUTHOR OF ┴╥├, WHICH ╔ USE TO CRUNCH
  THIS PROGRAM), AND SO ON. ╔F WE ALL ARE SOMEWHAT HONEST PEOPLE, THIS CONCEPT
  CAN REALLY WORK! (╚ECK OF A LOT CHEAPER THAN COMMERCIAL SOFTWARE!)
  ╔F YOU JUST USE THE PROGRAM FOR PERSONAL PURPOSES, THE DONATION IS SOMEWHAT
  VOLUNTARY. ╔F, HOWEVER, YOU UPLOAD THE FONTS TO ╤-╠INK OR A ┬┬╙, THE
  DONATION IS NOW MORE REQUIRED.

  ┼NOUGH TALK!

  ├HANGES FROM 1.1:

       1) ╘HE SAVE ROUTINE NOW WORKS CORRECTLY IN ALL SAVE OPTIONS! ┬EFORE IT
  WOULDN'T WRITE THE FILE LENGTH CORRECTLY AND 1.X VERSIONS OF GEO╫RITE WOULD
  GET ALL SCREWED UP! (128 VERSION WOULD CRASH!)
       2) ╘HE EDIT SCREEN HAS BEEN CHANGED A BIT TO MAKE IT EASIER TO READ
  WITH A BLACK/WHITE ╘╓/MONITOR.
       3) ╘HE EDIT MODE NOW ALLOWS THE USE OF CURSOR KEYS TO MOVE THE POINTER.
  (╔,╩,╦,═ ALSO)

       ╔F YOU HAVE ANY SUGGESTIONS FOR V2.0 (BUGS FOUND, FEATURES WANTED,
  ETC.) PLEASE LEAVE ME ┼-═AIL AS ╩IMBOB2 ON ╤-╠INK. ╘HANKS FOR ALL THE
  SUGGESTIONS YOU'VE ALREADY SENT, MOST OF THEM WILL BE IN 2.0.
       ┬EFORE ╔ START, ╔ WANT TO EXTEND THANKS TO ╞GK (AUTHOR OF THE GREAT
  GAMES ├╔╥├┼ AND ├╠╒╙╘┼╥ ╫┴╥╙), AND ┬╥╟ILSON (WHOSE FONT SCALER WILL APPEAR
  IN 2.0) FOR THEIR EXTENSIVE HELP WITH THE PROGRAM. ╫ITHOUT THEIR HELP IT
  WOULDN'T BE HERE TODAY! ╘╚┴╬╦╙ ┬╥╒├┼ & ╞╟╦!!!
       ╫ELL, NOW INTO THE PROGRAM OPERATION. ╘HE MAIN MENU HAS 5 OPTIONS EACH
  TO BE EXPLAINED SEPARATELY.
       ┬UT FIRST, YOU MUST KNOW HOW TO LOAD IT. ╚ERE IT IS:
  ╠╧┴─"╞╧╬╘ ┼─╔╘╧╥1.2",8 AND HIT RETURN. ╫HEN IT FINISHES LOADING, TYPE ╥╒╬
  AND HIT RETURN. ╘HEN THE BOOT PROGRAM SCREEN WILL APPEAR. ╔T WILL POKE IN
  THE ═ACHINE ╠ANGUAGE CODE AND THEN EXECUTE THE MAIN PROGRAM.












  ╚ERE ARE THE MENU OPTIONS, EACH EXPLAINED SEPARATELY:


  1) ╠OAD NEW FONT

        ╘HIS WILL NORMALLY BE THE FIRST OPTION SELECTED. (╒NLESS YOU USE #2.)
  ╘HE PROGRAM WILL PROMPT YOU TO INSERT A FONT DISK. ╔F THERE ARE NO FONTS ON
  THE DISK, YOU WILL BE ASKED FOR ANOTHER ONE.
       ╔T WILL READ THE DIRECTORY AND DISPLAY ALL THE FONTS. (1.2 NOW DISPLAYS
  LOCKED FILES.) ╘YPE IN THE NAME OF ONE, AND HIT RETURN. (╬OTE:
  ├APITALIZATION ─╧┼╙ COUNT- IF THE ORIGINAL NAME HAS CAPS, YOU MUST USE CAPS
  ALSO.) ╘HEN IT WILL LOOK UP THE POINT SIZES FOR THE FONT SELECTED. ┼NTER THE
  POINT SIZE AND HIT RETURN. ╘HEN THE SCREEN WILL BLANK. (╘HIS SPEEDS UP THE
  COMPUTER- SEE BELOW.) ╞IRST THE DRIVE WILL RUN AS IT LOADS THE FONT. ╘HEN
  THE SCREEN WILL START FLASHING COLORS. (POINT SIZE - 1 TIMES) ┴FTER THAT IS
  DONE, YOU WILL BE BROUGHT BACK TO THE MAIN MENU, AND THE FONT NAME IN MEMORY
  WILL BE DISPLAYED AT THE TOP OF THE SCREEN.

  2) ├REATE A BLANK FONT

       ╘HIS OPTION IS TO BE USED ONLY IF YOU ARE CREATING A FONT FROM SCRATCH.
  ╔T WILL ASK YOU FOR THE POINT SIZE, BASELINE (SEE OPTION 3), AND DEFAULT
  WIDTH. (╘HIS CAN BE CHANGED LATER.) ╘RY TO PICK AN AVERAGE WIDTH VALUE. (╔F
  YOU'RE CREATING A BIG FONT AND PICK A DEFAULT WIDTH OF 1, YOU WILL HAVE TO
  CHANGE IT A LOT!) ╘HEN THE FONT WILL BE CREATED. (┴T THE MOMENT IT WILL BE
  EMPTY.) ═AX POINT SIZE = 24, BASELINE <= POINT SIZE.

  3) ┼DIT A FONT

       ╞IRST IT WILL PUT UP A MENU ASKING HOW YOU WANT TO SELECT THE CHARACTER
  TO BE EDITED. ╘HE FIRST CHOICE, BY ┴╙├╔╔ CODE, ASKS YOU FOR THE ┴╙├╔╔ CODE
  OF THE CHARACTER. (╔T USES NORMAL ┴╙├╔╔, 32-64 ARE NUMBERS & PUNCTUATION,
  65-90 ARE UPPERCASE ┴-┌, AND 97-122 ARE LOWERCASE A-Z.) ╒SE THIS OPTION ONLY
  IF YOU KNOW THE ┴╙├╔╔ CODE. ╘HE SECOND CHOICE IS TO TYPE THE CHARACTER FROM
  THE KEYBOARD. ╩UST TYPE THE CHARACTER AND HIT ╥┼╘╒╥╬. (╬OTE: BECAUSE OF THE
  WAY THE INPUT STATEMENT WORKS, HITTING RETURN WITHOUT TYPING ANYTHING WILL
  GIVE YOU THE ╙╨┴├┼ (┴╙├╔╔ 32).)
       ╘HEN THE EDIT SCREEN WILL BE PUT UP. ╨LUG A JOYSTICK INTO PORT 2. ╘HE
  CHARACTER WILL BE DRAWN IN BLOCK GRAPHICS ON THE RIGHT, AND IT WILL ALSO BE
  DISPLAYED AS A SPRITE IN THE LOWER LEFT-HAND CORNER. (╘HERE WILL BE A SHORT
  LINE OUTSIDE THE CHARACTER WHERE THE BASELINE SITS: SEE BELOW.) ╒SE THE
  JOYSTICK OR CURSOR KEYS TO MOVE AROUND, AND HIT THE FIRE BUTTON OR SPACE BAR
  TO TOGGLE A PIXEL. ╨RESS ╚ FOR A HELP SCREEN DISPLAYING ALL THE COMMANDS.
  ╙INCE THEY ARE EXPLAINED IN THE HELP SCREEN, ╔'M NOT GOING TO PUT THEM HERE
  TOO. (╘RYING TO KEEP THE + TIME DOWN.!) ╚IT ╞1 TO MOVE FORWARD ONE
  CHARACTER, ╞3 TO GO BACK ONE, ╞5 TO RESELECT A CHARACTER (IF YOU WANT TO GO
  FROM A TO Z WITHOUT HITTING ╞3 25 TIMES) AND ╞7 TO EXIT EDIT MODE.
  ╬OTE: IN THE UPPER-LEFT OF THE SCREEN WILL BE SOME MISC. INFO: CHARACTER,
  ┴╙├╔╔ CODE, HEIGHT, WIDTH, AND BASELINE. ╙INCE THIS IS AN UPPERCASE/GRAPHICS
  SCREEN, UNDER THE ├╚┴╥┴├╘┼╥: HEADING YOU WILL SEE A NORMAL (UPPERCASE)
  LETTER IF THE LETTER IS LOWERCASE, AND A ╥┼╓┼╥╙┼ ╒╨╨┼╥├┴╙┼ ╠┼╘╘┼╥ IF THE
  CHARACTER BEING EDITED IS UPPERCASE. ╙OME OF THE CODES AFTER 122 WILL BE
  DIFFERENT THAN THE CHARACTER SHOWN AT THE TOP OF THE SCREEN. (BRACKETS,
  TILDA, ETC.)
  ╬OW FOR THE BASELINE EXPLANATION: THE BASELINE IS THE LINE WHERE THE
  UNDERLINE WILL GO. ╘HE CHARACTER SHOULD PRETTY MUCH "SIT" ON THE BASELINE,
  WITH DESCENDERS BEING UNDER IT. ╘HE BASELINE IS THE SAME FOR THE WHOLE FILE:
  YOU CAN'T CHANGE IT FOR EACH CHARACTER.








  4) ╙AVE A FONT

       3 MAIN OPTIONS HERE: PUT IN EXISTING FILE, CREATE NEW FILE, OR DON'T
  SAVE. ╘HE FIRST, PUT UNDER EXISTING FILE WILL LET YOU INSERT THE FONT UNDER
  AN EXISTING FILE. (╠ETS SAY YOU LOAD THE FILE ├ORY, 12 POINT, AND EDIT IT
  DOWN TO A 10 POINT FONT. ┘OU COULD SELECT SAVE OPTION 1 AND INSERT THE 10
  POINT FONT IN THE ├ORY FILE. ╘HEN WHEN YOU SELECT ├ORY YOU WOULD GET POINT
  SIZES 10,12, AND 24.) ╘HIS WILL PROBABLY BE THE MOST COMMON CHOICE. ╔T WILL
  REDISPLAY THE FONTS FOUND ON THE DISK, AND ASK YOU FOR ONE. ╘O NOT SAVE,
  JUST HIT RETURN. ┼NTER THE NAME OF THE FONT, AND HIT RETURN. ╔T WILL THEN
  CHECK TO SEE IF THE CURRENT POINT SIZE ALREADY EXISTS UNDER THAT FONT. ╔F
  SO, YOU WILL BE ASKED TO REPLACE IT, OR QUIT.
  ╘HE SECOND OPTION IS TO CREATE A NEW FONT FILE FROM SCRATCH. ┼NTER THE NAME
  OF THE FILE (AS YOU'D LIKE IT TO APPEAR UNDER ╟┼╧╙) AND HIT RETURN. ╔T WILL
  THEN SET UP THE SECTORS NEEDED FOR THE FONT. ┴FTER THAT, YOU WILL BE ASKED
  FOR THE FONT ╔─. ╘HIS IS A UNIQUE NUMBER FROM 0 TO 1023, USED TO IDENTIFY
  YOUR FONT WHEN ╟┼╧╙ CALLS UPON IT. ┬╙╫ HAS USED 0-30, AND MAYBE MORE ON THE
  NEW ╞ONT╨AK2. ╔T IS BEST TO AVOID NUMBERS UNDER 100. (╠EAVE THEM FOR ┬╙╫.)
       ╬OW THE FONT FILE WILL BE CREATED. ┴GAIN, THE SCREEN WILL BLANK. ┴LSO
  AGAIN, THE SCREEN WILL FLASH COLORS. ╫HEN THAT IS DONE, IF YOU SELECTED
  OPTION 1, YOU ARE ALL DONE. ╔F YOU SELECTED OPTION 2, YOU WILL BE ASKED THE
  DATE AND TIME. ╘HAT IS WRITTEN, AND YOU WILL BE BROUGHT BACK TO THE MAIN
  MENU.
       ╬OTE FOR OPTION 2: "├LASS" AND "╓ERSION ╬UMBER" ARE THINGS FOR THE INFO
  SECTOR, WILL APPEAR UNDER "├LASS". ═ANY PEOPLE HAVE BEEN USING "GEO╞ONT" FOR
  THE CLASS, FEEL FREE TO USE WHAT YOU WANT.

  5) ╤UIT

       ╬OT MUCH TO SAY HERE. ┘OU WILL BE TOLD IF YOUR FONT HAS NOT BEEN SAVED
  YET. ┘OU WILL ALWAYS BE GIVEN THE CHANCE TO BACK OUT. ╧NCE YOU QUIT, YOU
  WILL BA ABLE TO RE-╥╒╬ IT, BUT YOU WILL LOSE THE FONT IN ╥┴═.


  ╬OW FOR THOSE "NOTES":

       ╘HIS STATEMENT MAY CAUSE MIXED EMOTIONS, DEPENDING ON WHAT COMPUTER YOU
  HAVE. ╫╚┼╬┼╓┼╥ ╘╚┼ ╙├╥┼┼╬ ┬╠┴╬╦╙, ╘╚┼ ╨╥╧╟╥┴═ ╥╒╬╙ ╘╫╔├┼ ┴╙ ╞┴╙╘ ╧╬ ┴
  ├╧══╧─╧╥┼ 128 ┴╙ ╧╨╨╧╙┼─ ╘╧ ┴ 64. ╘HE 128'S MICRO (8502) SUPPORTS BOTH 1 AND
  2 ═╚Z MODES. ┘╧╒ ├┴╬ ┴├├┼╙╙ 2═╚Z ═╧─┼ ╞╥╧═ 64 ═╧─┼!!! ╔T CAUSES THE SCREEN
  TO BLANK (JUST LIKE 128 40-COLUMN) BUT THEN AGAIN, THIS PROGRAM ALREADY
  BLANKS IT! ─ON'T WORRY THOUGH (NORMAL 64 USERS), THIS PROGRAM RUNS PRETTY
  FAST AS IT IS. ╔T WAS WRITTEN IN ┬┴╙╔├ AND COMPILED WITH ┴USTRO-╙PEED.
  ╬OTE: WHEN ╔ SAY ├OMMODORE 128 ╔ MEAN LITERALLY THE ├OMMODORE 128 COMPUTER,
  ╬╧╘ ├-128 MODE. ╔T WILL ONLY RUN IN 64 MODE, ALTHOUGH YOU CAN STILL USE 2═╚Z
  IN 64 MODE. ╔F YOU ARE INTERESTED, THE COMMAND FROM ┬┴╙╔├ IS ╨╧╦┼ 53296,1 TO
  GO INTO 2═╚Z MODE. ╘HE SCREEN WILL GO CRAZY, SO IT IS ADVISED THAT YOU USE
  THE NORMAL SCREEN BLANK FEATURE IN REGISTER 53265 ALSO. ╘O GO BACK TO 1═╚Z
  MODE, TYPE ╨╧╦┼ 53296,0
       ╘HAT'S HOW YOU DO IT! ╨LEASE NOTE, HOWEVER, THAT YOU CANNOT PERFORM ANY
  ╔/╧ OPERATIONS (DISK, PRINTER, TAPE) IN 2 ═╚Z MODE IN 64 MODE.

  ┴╬╧╘╚┼╥ ╬╧╘┼: ╒╙┼ ╘╚╔╙ ╙╧╞╘╫┴╥┼ ╧╬╠┘ ╧╬ ┴ ┬┴├╦╒╨ ╞╧╬╘ ─╔╙╦. ─╧ ╬╧╘, ╥┼╨┼┴╘
  ─╧ ╬╧╘, ╒╙┼ ╘╚╔╙ ╧╬ ┴ ╟╧╧─ ─╔╙╦, ┴╙ ╔╘ ├┴╬ ╘╚╥┴╙╚ ┴ ╫╚╧╠┼ ─╔╙╦ ╔╞ ╙╧═┼╘╚╔╬╟
  ╟╧┼╙ ╫╥╧╬╟. ┴╠╫┴┘╙ ╒╙┼ ┴ ┬┴├╦╒╨ ─╔╙╦!!!!!!!!!!!!!!!!!!

  ╫ELL, ╔ THINK THAT'S ABOUT IT. ╔F YOU FIND ANYTHING WRONG WITH THIS, PLEASE
  LET ME KNOW. (╩IMBOB2)

     ╠ATER ALL,
       ╩IM ├OLLETTE      ^